Storage Installation Properties

The configuration settings read by the RHQ Storage Installer are stored in the rhq-storage.properties file located in the /bin directory of the server distribution. Once the storage node is installed the settings in this file are no longer used. Management of existing storage nodes are performed via the RHQ GUI and the RHQ Agent monitoring the storage node.

It is not necessary to edit the file prior to installation, as default values can be used, especially in test environments. For production installations it is likely that some customization will be desired.

Below are the configuration properties.

Data Directory Settings

These properties define where on the file system the RHQ Storage Node will store its data. For larger installations this may require significant disk space.

The RHQ_HOME directory as used below is the parent directory of the RHQ server installation. It is recommended that RHQ be installed under an umbrella "rhq" directory. For example, if using a home directory of /opt/rhq then the default installation structure would be:

   /opt/rhq
   /opt/rhq/rhq-server-RHQ-VERSION
   /opt/rhq/rhq-server-RHQ-VERSION/rhq-storage
   /opt/rhq/rhq-agent
   /opt/rhq/rhq-data/
   /opt/rhq/rhq-data/storage/commitlog
   /opt/rhq/rhq-data/storage/data
   /opt/rhq/rhq-data/storage/saved_caches

IMPORTANT: Always use forward slashes in the directory path names, even on Windows!

IMPORTANT: If using non-default settings for the data, commitlog, and/or saved-caches directories, each directory should be unique, typically under a common parent.

Property	Description
rhq.storage.commitlog	The directory where the storage node keeps commit log files. Defaults to: RHQ_HOME/rhq-data/storage/commitlog
rhq.storage.data	The directory where the storage node keeps data files. Defaults to: RHQ_HOME/rhq-data/storage/data
rhq.storage.saved-caches	The directory where the storage node keeps saved cache files. Defaults to: RHQ_HOME/rhq-data/storage/saved_caches

Heap/Memory Settings

These properties help define the amount of memory devoted to the RHQ Storage Node process.

Property	Description
rhq.storage.heap-size	The value to use for both the min and max heap. This value is passed directly to the -Xms and -Xmx options of the Java executable. Defaults to 512M.
rhq.storage.heap-new-size	The value to use for both the min and max heap. This value is passed directly to the -Xmn option of the Java executable. Defaults to 128M.
rhq.storage.stack-size	The value to use for the thread stack size. This value is passed directly to the -Xss option of the Java executable. Defaults to 256k.

Port Settings

These properties define the ports used for the RHQ Storage Node. Some of these settings must be applied consistently across all Storage Nodes in the storage cluster. For more information see Cluster Settings.

Property	Description
rhq.storage.cql-port	The port on which to listen for client requests. Defaults to 9142.
rhq.storage.jmx-port	The port on which to listen for JMX connections. Defaults to 7299.
rhq.storage.gossip-port	The port on which to listen for requests from other nodes. Defaults to 7100.

Address/Host Settings

These properties define the hosts/addresses used for the RHQ Storage Node.

Property	Description
rhq.storage.hostname	The hostname or IP address on which the node will listen for requests. Defaults to this node's hostname.
rhq.storage.seeds	A comma-delimited list of hostnames or IP addresses that serve as contact points. Nodes use this list to find each other and to learn the cluster topology. It does not need to specify all nodes in the cluster. Defaults to this node's hostname.

Advanced Settings

Additional properties that can be set.

Property	Description
rhq.storage.verify-data-dirs-empty	If true then allow installation only when the data directories are empty. Typically set true only in development environments when it may be useful to perform a clean installation while maintaining existing data. Defaults to true.